home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 2000 October / Software of the Month - Ultimate Collection Shareware 277.iso / pc / PROGRAMS / UTILITY / WINLINUX / DATA1.CAB / programs_-_usrdoc / GPM / README.{_2 < prev   
Text File  |  1999-09-17  |  9KB  |  265 lines
  1. /*
  2.  * README -- gpm-Linux 1.xx
  3.  *
  4.  * Copyright 1995-1998   rubini@linux.it (Alessandro Rubini)
  5.  *
  6.  *******/
  7.  
  8. The gpm (general purpose mouse) daemon tries to be a useful mouse
  9. server for applications running on the Linux console.  Its roots are
  10. in the "selection" package, by Andrew Haylett, and the original code
  11. comes from selection itself. This package is intended as a replacement
  12. for "selection", to provide additional facilities.  From 0.18 onward
  13. gpm supports xterm as well, so you can run mouse-sensitive
  14. applications under X, and you can easily write curses applications
  15. which support the mouse on both the Linux console and xterm. The xterm
  16. code is portable to any U*x flavour (look at sample/README).
  17.  
  18. The first clients have been "The Midnight Commander", by Miguel de
  19. Icaza and an emacs library included in this release. Recent dialog
  20. distributions and the Jed editor use gpm as well, and the same do
  21. several custom applications.
  22.  
  23. =========== MAINTAINANCE
  24.  
  25. With version 1.14, I released exclusive maintainace. Ian Zimmerman is
  26. going to support gpm development, with help from Prosa Srl., a new
  27. italian company devoted to free software. The mailing list devoted to
  28. gpm is "gpm@prosa.it" (managed by smartlist). The list is currently
  29. hosted by my university, which I wish to thank.  Feel free to contact
  30. either Ian (itz@rahul.net) or me (rubini@linux.it) if you feel more
  31. inclined to personal talks. Note however that both Ian and me are
  32. subscribed to the gpm mailing list.
  33.  
  34. =========== COMPILING AND INSTALLING
  35.  
  36. The package uses autoconf as of 1.11. Use "./configure && make"
  37. to compile the gpm suite.
  38.  
  39. To install "make install". This installs binaries in /usr/bin,
  40. libraries in /usr/lib, man pages in /usr/man, the lisp library in
  41. /usr/lib/emacs/site-lisp and the info file in /usr/info.
  42.  
  43. If any error occur, please report them to me. Something like this
  44. could be an easy (though brutal) way to do it:
  45.  make clean; (uname -a; make) |& elm -s "gpm compile err." rubini@systemy.it
  46.  
  47. To install under /usr/local or /usr/tools or wherever you want,
  48. you can specify the "prefix" to ./configure. Try "./configure --help"
  49. for more hints.
  50.  
  51. What remains to do after installation  is a little configuration
  52.  
  53. =========== CONFIGURING
  54.  
  55. Configuration is optional...
  56.  
  57. * You would like to tell emacs to use t-mouse.el when appropriate. Add
  58.     the following lines to your own .emacs (in your home
  59.     directory), or in the /usr/lib/emacs/site-lisp/default
  60.  
  61.     (if (and (string-match ".*-linux" system-configuration)
  62.                  (not window-system)
  63.              (or (string-match "linux" (getenv "TERM"))
  64.                  (string-match "con.*" (getenv "TERM"))))
  65.         (load-library "t-mouse"))
  66.  
  67. * If you want to use gpm-root, copy gpm-root.conf to your /etc
  68.     directory, test it out and then edit it to suit your feels.
  69.  
  70. * You'd like to name the gpm info file inside /usr/info/dir. Just insert
  71.     the line
  72.         * gpm-Linux: (gpm.info).  A mouse server for the Linux console
  73.     at the proper place.
  74.     
  75. * To invoke gpm (and gpm-root) at system boot, add something like this
  76.     to your /etc/rc.d/rc.local
  77.  
  78.         /usr/bin/gpm -t msc &
  79.         /usr/bin/gpm-root &
  80.  
  81.     If you are running the new setup of SysVinit, you should better
  82.     add a "gpm" script in /etc/rc.d/rc.init and install it in your
  83.     runlevels in the usual way.
  84.  
  85.  
  86.     You may want to put the mouse server at a higher priority: in
  87.     this case invoke instead "/usr/bin/nice -n -20 /usr/bin/gpm -t
  88.     msc &"
  89.  
  90.     Actually, the program goes to the background by itself, unless
  91.     it is compiled with debuging enabled: the "&" above is just in
  92.     case you install a debugging version of the daemon.
  93.  
  94. =========== DOCS
  95.  
  96. The directory "./doc" holds the documentation. The release embeds a
  97. postscript file, slightly reduced to save paper (doc/gpm2.ps), an info
  98. one (doc/gpm.info) and a text-only version (doc/gpmdoc.txt -- but
  99. without table of contents, by now).  Man pages are automatically
  100. extracted from the info file, and are installed with "make install"
  101.  
  102. =========== BUG REPORTS
  103.  
  104. Before sending bug reports, please look at the file "FAQ",
  105. which outlines some known problems, and how to deal with them.
  106.  
  107. If your bug isn't fixed by reading there, please report it to me,
  108. without getting angry with me if things don't work at first trial
  109. (but they usually work).
  110.  
  111. Bug reports are best sent to me via email, including the string "gpm"
  112. somewhere in the subject line. This will help deliver in sorting things out.
  113.  
  114. * When compilation fails I need your kernel version ("uname -a"), the
  115. compiler version ("gcc -v") and the library version ("ls -l /lib").
  116. And the compiler messages, obviously.
  117.  
  118. * When a program hangs or segfaults, please reinvoke the program under strace:
  119.     strace -tf -o /tmp/trace.gpm gpm -t msc
  120.                                      ^^^^^^^^^^ put your true cmdline here.
  121. Then send me /tmp/trace.gpm* (they may be one or two files, according
  122. to the strace version), and a description of how you reproduce the problem.
  123.  
  124. The last resort is a core dump, but I'll ask it personally if I have real
  125. difficulties in tracing out your problem.
  126.  
  127. =========== AVAILABILITY 
  128.  
  129. The latest release is available by ftp from iride.unipv.it:/pub/gpm
  130. Feel free to call me to report/fix bugs.  If you are willing to write
  131. a client I'd like to know as well.
  132.  
  133. =========== CREDITS
  134.  
  135. The following people contributed to gpm, in chronological order. This
  136. list used to reside in a different file, but it's better for it to stand
  137. out in the README
  138.  
  139. Andrew Haylett (ajh@gec-mrc.co.uk)
  140.         donated "selection" to the linux community, so I could get
  141.         the idea and the code. A few others contributed to selection,
  142.         but I lost track of their contributions and names.
  143.  
  144. Steven S. Dick (ssd@nevets.oau.org)
  145.         fixed a pair of bugs in early gpm versions.
  146.  
  147. Miguel de Icaza (miguel@roxanne.nuclecu.unam.mx)
  148.         helped fixing some bugs and provided a good client to test
  149.         my server. He helped a lot in testing the various pre-releases.
  150.  
  151. Olav Woelfelschneider (wosch@rbg.informatik.th-darmstadt.de)
  152.         fixed 0.10 with MouseSystems compatible mice.
  153.  
  154. Janne Kukonlehto (jtklehto@stekt.oulu.fi)
  155.         provided xterm mouse decoding to be stolen by me.
  156.  
  157. Rick Lyons (rick@razorback.brisnet.org.au)
  158.         fixed a bug in gpm-0.9.
  159.  
  160. Reuben Sumner (rasumner@undergrad.math.uwaterloo.ca)
  161.         helped fixing behaviour with "-t bm".
  162.  
  163. Larry Bartholdi (lbartho@scsun.unige.ch)
  164.         pinpointed an error in t-mouse-suspend
  165.         and provided good suggestions for 0.97.
  166.  
  167. Mark Lord (mlord@bnr.ca)
  168.         ported to Dexxa/Logitech mice and gave feedback several times.
  169.  
  170. Stefan Giessler (stg@gandalf.han.de)
  171.         fixed some problems with gpm-root and
  172.         suggested to put gpm in the background (0.97).
  173.  
  174. Roman Shapiro
  175.         helped with the Logitech MouseMan.
  176.  
  177. Andries Brouwer (aeb@cwi.nl)
  178.         Provided a Latin-1 LUT for chars, and enhanced
  179.         lut-loading code (0.98).
  180.  
  181. Adrian Johnson (ajohnson@apanix.apana.org.au)
  182.         Gave good feedback and ideas for the 0.98's
  183.  
  184. Stephen Lee (sl14@crux1.cit.cornell.edu)
  185.         Helped a lot with the damned MouseMan protocol (0.98 and 1.0)
  186.  
  187. John van Leeuwen (johnvl@einstein.et.tudelft.nl)
  188.         Outlined and fixed a pair of bugs in gpm-root 0.98
  189.  
  190. Alvar Bray (alvar@meiko.co.uk)
  191.         Pointed out an error with awk (0.99)
  192.  
  193. David A. van Leeuwen (david@tm.tno.nl)
  194.         Helped with chord-middle protocols (1.0)
  195.  
  196. Ian T Zimmerman (itz@rahul.net)
  197.         Greatly enhanced t-mouse.el (1.0)
  198.         Fixed gpm.c to manage all the clients on a console. (1.11)
  199.         Support for SIGTSTP in Gpm_Open() (1.11)
  200.  
  201. Pavel Kankovsky (KAN@frode.dcit.cz)
  202.         Open /dev/ttyxx instead of /dev/console in the lib (1.01)
  203.  
  204. Mark Shadley (shadcat@catcher.com) 
  205.         Helped in turning to ELF (1.01 and 1.02) and in fixing
  206.         horrible bugs of mine. Without his help 1.03 wouldn't be there.
  207.  
  208. Lou Sortman (lou@lounix4.conc.tdsnet.com)
  209.         Added support for glidepoint mice within "-t mman". (1.05)
  210.  
  211. Marc Meis (100334.1426@compuserve.com)
  212.         Provided support for absolute pointing devices, and in
  213.         particular for the ncr3125 pen. (1.05)
  214.  
  215. Michael Plass (Michael_Plass.PARC@xerox.com)
  216.         Fixed a damned bug in middle button decoding (M_ms) (1.07)
  217.  
  218. Markus Gutschke (gutschk@uni-muenster.de)
  219.         Provided a better re-encoding for "-R" (1.10)
  220.  
  221. Karsten Ballueder (Karsten@piobelix.physik.uni-karlsruhe.de)
  222.         Suggested the reboot compile-time option (1.10)
  223.  
  224. John Davis (davis@space.mit.edu)
  225.         Found and fixed a buglet in liblow.c for some jed users (1.10)
  226.  
  227. Julian Thompson (jrt@miel.demon.co.uk)
  228.         Fixed a buglet in gpm-root (1.10)
  229.  
  230. Dave Flater (dave@universe.digex.net)
  231.         Removed a typo in the disabled decoder for ms-3b (1.11)
  232.  
  233. Thomas E. Dickey (dickey@clark.net)
  234.         Ported to autoconf (1.11)
  235.  
  236. Pavel Machek (pavel@Elf.mj.gts.cz)
  237.         New mode "logim" (1.11) and NetMouse (1.14)
  238.  
  239. Matthias Grimrath (y0001032@rzserv8.rz.tu-bs.de)
  240.         Be c++ compliant in gpm.h (1.11)
  241.  
  242. Stephen Tell (tell@cs.unc.edu)
  243.         Patch for the ps2 decoder to support misbehaving devices (1.11)
  244.  
  245. Francois Chastrette (no-email)
  246.         Great help to support plugnpray mice (1.13)
  247.  
  248. Steve Bennett (s.bennett@lancaster.ac.uk)
  249.         Support for the intellimouse serial devices. (1.13)
  250.  
  251. Jan Daciuk (jandac@pg.gda.pl)
  252.         t-mouse: yet another regexp possibility
  253.  
  254. Ian Zimmerman is now actively cooperating in maintaining gpm, so
  255. he'll no longer appear in the acknoledgements ;-)
  256.  
  257. David Given (dg@tao.co.uk)
  258.         Offered support for joystick mouse emulation (1.14)
  259.  
  260. Tim Goodwin (tgoodwin@cygnus.co.uk)<F2>
  261. Colin Plumb (colin@nyx10.nyx.net)
  262. Ben Pfaff (pfaffben@pilot.msu.edu)
  263. Ian and Iris (brooke@jump.net)
  264.         All of them sent in support for ps2 intellimouse (1.14)
  265.